4.5. Creating Calendar Object Resources

Creating calendar object resources is carried out by using a CalWS-SOAP addItem request targeted at the parent collection and containing the resource to be created. The response will contain the href of the newly created object.

The iCalendar entity in the request MUST contain only a single calendaring entity with any related overrides.

Table 27 — AddItemType fields

Field	Type	#	?	Description
`href`	string	1	Y	Identify the target of the request.
`icalendar`	`xcal:IcalendarType`	1	Y	The entity to be created

The service will respond with an AddItemResponseType giving either the href and change token of the new entity or an error response.

Table 28 — AddItemResponseType additional fields

Field	Type	#	?	Description
`href`	string	0..1	N	`Href` of the new entity for a successful request.
`changeToken`	string	0..1	N	Change token for the new entity